home *** CD-ROM | disk | FTP | other *** search
/ Chip 2007 January, February, March & April / Chip-Cover-CD-2007-02.iso / Pakiet internetowy / Przegladarki internetowe / Mozilla Seamonkey 1.0.5 pl / seamonkey-1.0.5.pl-PL.win32.installer.exe / VENKMAN.XPI / bin / chrome / venkman.jar / content / venkman / venkman-utils.js < prev    next >
Encoding:
JavaScript  |  2004-07-19  |  24.7 KB  |  1,025 lines
  1. /* -*- Mode: C++; tab-width: 8; indent-tabs-mode: nil; c-basic-offset: 4 -*-
  2.  *
  3.  * ***** BEGIN LICENSE BLOCK *****
  4.  * Version: MPL 1.1/GPL 2.0/LGPL 2.1
  5.  *
  6.  * The contents of this file are subject to the Mozilla Public License Version
  7.  * 1.1 (the "License"); you may not use this file except in compliance with
  8.  * the License. You may obtain a copy of the License at
  9.  * http://www.mozilla.org/MPL/
  10.  *
  11.  * Software distributed under the License is distributed on an "AS IS" basis,
  12.  * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
  13.  * for the specific language governing rights and limitations under the
  14.  * License.
  15.  *
  16.  * The Original Code is mozilla.org code.
  17.  *
  18.  * The Initial Developer of the Original Code is
  19.  * New Dimensions Consulting, Inc.
  20.  * Portions created by the Initial Developer are Copyright (C) 1999
  21.  * the Initial Developer. All Rights Reserved.
  22.  *
  23.  * Contributor(s):
  24.  *   Robert Ginda, rginda@ndcico.com, original author
  25.  *
  26.  * Alternatively, the contents of this file may be used under the terms of
  27.  * either the GNU General Public License Version 2 or later (the "GPL"), or
  28.  * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
  29.  * in which case the provisions of the GPL or the LGPL are applicable instead
  30.  * of those above. If you wish to allow use of your version of this file only
  31.  * under the terms of either the GPL or the LGPL, and not to allow others to
  32.  * use your version of this file under the terms of the MPL, indicate your
  33.  * decision by deleting the provisions above and replace them with the notice
  34.  * and other provisions required by the GPL or the LGPL. If you do not delete
  35.  * the provisions above, a recipient may use your version of this file under
  36.  * the terms of any one of the MPL, the GPL or the LGPL.
  37.  *
  38.  * ***** END LICENSE BLOCK ***** */
  39.  
  40. var dumpln;
  41. var dd;
  42.  
  43. const nsIBaseWindow         = Components.interfaces.nsIBaseWindow;
  44. const nsIXULWindow          = Components.interfaces.nsIXULWindow;
  45. const nsIInterfaceRequestor = Components.interfaces.nsIInterfaceRequestor;
  46. const nsIWebNavigation      = Components.interfaces.nsIWebNavigation;
  47. const nsIDocShellTreeItem   = Components.interfaces.nsIDocShellTreeItem;
  48.  
  49. var utils = new Object();
  50.  
  51. if (typeof document == "undefined") /* in xpcshell */
  52. {
  53.     dumpln = print;
  54. }
  55. else
  56. {
  57.     if (typeof dump == "function")
  58.         dumpln = function (str) {dump (str + "\n");}
  59.     else if (jsenv.HAS_RHINO)
  60.     {
  61.         dumpln = function (str) {
  62.                      var out = java.lang.System.out;
  63.                      out.println(str); out.flush();
  64.                  }
  65.     }
  66.     else
  67.         dumpln = function () {} /* no suitable function */
  68. }
  69.  
  70. if (DEBUG) {
  71.     var _dd_pfx = "";
  72.     var _dd_singleIndent = "  ";
  73.     var _dd_indentLength = _dd_singleIndent.length;
  74.     var _dd_currentIndent = "";
  75.     var _dd_lastDumpWasOpen = false;
  76.     var _dd_timeStack = new Array();
  77.     var _dd_disableDepth = Number.MAX_VALUE;
  78.     var _dd_currentDepth = 0;
  79.     dd = function _dd (str) {
  80.              if (typeof str != "string") {
  81.                  dumpln (str);
  82.              } else if (str[str.length - 1] == "{") {
  83.                  ++_dd_currentDepth;
  84.                  if (_dd_currentDepth >= _dd_disableDepth)
  85.                      return;
  86.                  if (str.indexOf("OFF") == 0)
  87.                      _dd_disableDepth = _dd_currentDepth;
  88.                  _dd_timeStack.push (new Date());
  89.                  if (_dd_lastDumpWasOpen)
  90.                      dump("\n");
  91.                  dump (_dd_pfx + _dd_currentIndent + str);
  92.                  _dd_currentIndent += _dd_singleIndent;
  93.                  _dd_lastDumpWasOpen = true;
  94.              } else if (str[0] == "}") {
  95.                  if (--_dd_currentDepth >= _dd_disableDepth)
  96.                      return;
  97.                  _dd_disableDepth = Number.MAX_VALUE;
  98.                  var sufx = (new Date() - _dd_timeStack.pop()) / 1000 + " sec";
  99.                  _dd_currentIndent = 
  100.                      _dd_currentIndent.substr (0, _dd_currentIndent.length -
  101.                                                _dd_indentLength);
  102.                  if (_dd_lastDumpWasOpen)
  103.                      dumpln (str + " " + sufx);
  104.                  else
  105.                      dumpln (_dd_pfx + _dd_currentIndent + str + " " + sufx);
  106.                  _dd_lastDumpWasOpen = false;
  107.              } else {
  108.                  if (_dd_currentDepth >= _dd_disableDepth)
  109.                      return;
  110.                  if (_dd_lastDumpWasOpen)
  111.                      dump ("\n");
  112.                  dumpln (_dd_pfx + _dd_currentIndent + str);
  113.                  _dd_lastDumpWasOpen = false;
  114.              }    
  115.          }
  116. } else {
  117.     dd = function (){};
  118. }
  119.  
  120. var jsenv = new Object();
  121. jsenv.HAS_SECURITYMANAGER = ((typeof netscape == "object") &&
  122.                              (typeof netscape.security == "object"));
  123. jsenv.HAS_XPCOM = ((typeof Components == "object") &&
  124.                    (typeof Components.classes == "object"));
  125. jsenv.HAS_JAVA = (typeof java == "object");
  126. jsenv.HAS_RHINO = (typeof defineClass == "function");
  127. jsenv.HAS_DOCUMENT = (typeof document == "object");
  128.  
  129. /* Dumps an object in tree format, recurse specifiec the the number of objects
  130.  * to recurse, compress is a boolean that can uncompress (true) the output
  131.  * format, and level is the number of levels to intitialy indent (only useful
  132.  * internally.)  A sample dumpObjectTree (o, 1) is shown below.
  133.  *
  134.  * + parent (object)
  135.  * + users (object)
  136.  * | + jsbot (object)
  137.  * | + mrjs (object)
  138.  * | + nakkezzzz (object)
  139.  * | *
  140.  * + bans (object)
  141.  * | *
  142.  * + topic (string) 'ircclient.js:59: nothing is not defined'
  143.  * + getUsersLength (function) 9 lines
  144.  * *
  145.  */
  146. function dumpObjectTree (o, recurse, compress, level)
  147. {
  148.     var s = "";
  149.     var pfx = "";
  150.  
  151.     if (typeof recurse == "undefined")
  152.         recurse = 0;
  153.     if (typeof level == "undefined")
  154.         level = 0;
  155.     if (typeof compress == "undefined")
  156.         compress = true;
  157.     
  158.     for (var i = 0; i < level; i++)
  159.         pfx += (compress) ? "| " : "|  ";
  160.  
  161.     var tee = (compress) ? "+ " : "+- ";
  162.  
  163.     for (i in o)
  164.     {
  165.         var t;
  166.         try
  167.         {
  168.             t = typeof o[i];
  169.         
  170.             switch (t)
  171.             {
  172.                 case "function":
  173.                     var sfunc = String(o[i]).split("\n");
  174.                     if (sfunc[2] == "    [native code]")
  175.                         sfunc = "[native code]";
  176.                     else
  177.                         sfunc = sfunc.length + " lines";
  178.                     s += pfx + tee + i + " (function) " + sfunc + "\n";
  179.                     break;
  180.                     
  181.                 case "object":
  182.                     s += pfx + tee + i + " (object) " + o[i] + "\n";
  183.                     if (!compress)
  184.                         s += pfx + "|\n";
  185.                     if ((i != "parent") && (recurse))
  186.                         s += dumpObjectTree (o[i], recurse - 1,
  187.                                              compress, level + 1);
  188.                     break;
  189.                     
  190.                 case "string":
  191.                     if (o[i].length > 200)
  192.                         s += pfx + tee + i + " (" + t + ") " + 
  193.                             o[i].length + " chars\n";
  194.                     else
  195.                         s += pfx + tee + i + " (" + t + ") '" + o[i] + "'\n";
  196.                     break;
  197.                     
  198.                 default:
  199.                     s += pfx + tee + i + " (" + t + ") " + o[i] + "\n";
  200.             }
  201.         }
  202.         catch (ex)
  203.         {
  204.             s += pfx + tee + i + " (exception) " + ex + "\n";
  205.         }
  206.  
  207.         if (!compress)
  208.             s += pfx + "|\n";
  209.  
  210.     }
  211.  
  212.     s += pfx + "*\n";
  213.     
  214.     return s;
  215.     
  216. }
  217.  
  218. function safeHTML(str)
  219. {
  220.     function replaceChars(ch)
  221.     {
  222.         switch (ch)
  223.         {
  224.             case "<":
  225.                 return "<";
  226.             
  227.             case ">":
  228.                 return ">";
  229.                     
  230.             case "&":
  231.                 return "&";
  232.         }
  233.  
  234.         return "?";
  235.     };
  236.         
  237.     return String(str).replace(/[<>&]/g, replaceChars);
  238. }
  239.  
  240. function alert(msg, parent, title)
  241. {
  242.     var PROMPT_CTRID = "@mozilla.org/embedcomp/prompt-service;1";
  243.     var nsIPromptService = Components.interfaces.nsIPromptService;
  244.     var ps = Components.classes[PROMPT_CTRID].getService(nsIPromptService);
  245.     if (!parent)
  246.         parent = window;
  247.     if (!title)
  248.         title = MSG_ALERT;
  249.     ps.alert (parent, title, msg);
  250. }
  251.  
  252. function confirm(msg, parent, title)
  253. {
  254.     var PROMPT_CTRID = "@mozilla.org/embedcomp/prompt-service;1";
  255.     var nsIPromptService = Components.interfaces.nsIPromptService;
  256.     var ps = Components.classes[PROMPT_CTRID].getService(nsIPromptService);
  257.     if (!parent)
  258.         parent = window;
  259.     if (!title)
  260.         title = MSG_CONFIRM;
  261.     return ps.confirm (parent, title, msg);
  262. }
  263.  
  264. function prompt(msg, initial, parent, title)
  265. {
  266.     var PROMPT_CTRID = "@mozilla.org/embedcomp/prompt-service;1";
  267.     var nsIPromptService = Components.interfaces.nsIPromptService;
  268.     var ps = Components.classes[PROMPT_CTRID].getService(nsIPromptService);
  269.     if (!parent)
  270.         parent = window;
  271.     if (!title)
  272.         title = MSG_PROMPT;
  273.     rv = { value: initial };
  274.  
  275.     if (!ps.prompt (parent, title, msg, rv, null, {value: null}))
  276.         return null;
  277.  
  278.     return rv.value
  279. }
  280.  
  281. function getChildById (element, id)
  282. {
  283.     var nl = element.getElementsByAttribute("id", id);
  284.     return nl.item(0);
  285. }
  286.  
  287. function openTopWin (url)
  288. {
  289.     var window = getWindowByType ("navigator:browser");
  290.     if (window)
  291.     {
  292.         var base = getBaseWindowFromWindow (window);
  293.         if (base.enabled)
  294.         {
  295.             window.focus();
  296.             window._content.location.href = url;
  297.             return window;
  298.         }
  299.     }
  300.  
  301.     return openDialog (getBrowserURL(), "_blank", "chrome,all,dialog=no", url);
  302. }
  303.     
  304. function getWindowByType (windowType)
  305. {
  306.     const MEDIATOR_CONTRACTID =
  307.         "@mozilla.org/appshell/window-mediator;1";
  308.     const nsIWindowMediator  = Components.interfaces.nsIWindowMediator;
  309.  
  310.     var windowManager =
  311.         Components.classes[MEDIATOR_CONTRACTID].getService(nsIWindowMediator);
  312.  
  313.     return windowManager.getMostRecentWindow(windowType);
  314. }
  315.  
  316. function htmlVA (attribs, href, contents)
  317. {
  318.     if (!attribs)
  319.         attribs = {"class": "venkman-link", target: "_content"};
  320.     else if (attribs["class"])
  321.         attribs["class"] += " venkman-link";
  322.     else
  323.         attribs["class"] = "venkman-link";
  324.  
  325.     if (typeof contents == "undefined")
  326.     {
  327.         contents = htmlSpan();
  328.         insertHyphenatedWord (href, contents);
  329.     }
  330.     
  331.     return htmlA (attribs, href, contents);
  332. }
  333.  
  334. function insertHyphenatedWord (longWord, containerTag)
  335. {
  336.     var wordParts = splitLongWord (longWord, MAX_WORD_LEN);
  337.     containerTag.appendChild (htmlWBR());
  338.     for (var i = 0; i < wordParts.length; ++i)
  339.     {
  340.         containerTag.appendChild (document.createTextNode (wordParts[i]));
  341.         if (i != wordParts.length)
  342.             containerTag.appendChild (htmlWBR());
  343.     }
  344. }
  345.  
  346. function insertLink (matchText, containerTag)
  347. {
  348.     var href;
  349.     var linkText;
  350.     
  351.     var trailing;
  352.     ary = matchText.match(/([.,]+)$/);
  353.     if (ary)
  354.     {
  355.         linkText = RegExp.leftContext;
  356.         trailing = ary[1];
  357.     }
  358.     else
  359.     {
  360.         linkText = matchText;
  361.     }
  362.  
  363.     var ary = linkText.match (/^(\w[\w-]+):/);
  364.     if (ary)
  365.     {
  366.         if (!("schemes" in utils))
  367.         {
  368.             var pfx = "@mozilla.org/network/protocol;1?name=";
  369.             var len = pfx.length
  370.  
  371.             utils.schemes = new Object();
  372.             for (var c in Components.classes)
  373.             {
  374.                 if (c.indexOf(pfx) == 0)
  375.                     utils.schemes[c.substr(len)] = true;
  376.             }
  377.         }
  378.         
  379.         if (!(ary[1] in utils.schemes))
  380.         {
  381.             insertHyphenatedWord(matchText, containerTag);
  382.             return;
  383.         }
  384.  
  385.         href = linkText;
  386.     }
  387.     else
  388.     {
  389.         href = "http://" + linkText;
  390.     }
  391.  
  392.     var anchor = htmlVA (null, href, "");
  393.     insertHyphenatedWord (linkText, anchor);
  394.     containerTag.appendChild (anchor);
  395.     if (trailing)
  396.         insertHyphenatedWord (trailing, containerTag);
  397.     
  398. }
  399.  
  400. function insertQuote (matchText, containerTag, msgtype)
  401. {
  402.     if (msgtype[0] == "#")
  403.     {
  404.         containerTag.appendChild(document.createTextNode(matchText));
  405.         return;
  406.     }
  407.     
  408.     if (matchText == "``")
  409.         containerTag.appendChild(document.createTextNode("\u201c"));
  410.     else
  411.         containerTag.appendChild(document.createTextNode("\u201d"));
  412. }
  413.  
  414. /* length should be an even number >= 6 */
  415. function abbreviateWord (str, length)
  416. {
  417.     if (str.length <= length || length < 6)
  418.         return str;
  419.  
  420.     var left = str.substr (0, (length / 2) - 1);
  421.     var right = str.substr (str.length - (length / 2) + 1);
  422.  
  423.     return left + "..." + right;
  424. }
  425.  
  426. function toBool (val)
  427. {
  428.     switch (typeof val)
  429.     {
  430.         case "boolean":
  431.             return val;
  432.     
  433.         case "number":
  434.             return val != 0;
  435.             
  436.         default:
  437.             val = String(val);
  438.             /* fall through */
  439.  
  440.         case "string":
  441.             return (val.search(/true|on|yes|1/i) != -1);
  442.     }
  443.  
  444.     return null;
  445. }
  446.  
  447. /* some of the drag and drop code has an annoying appetite for exceptions.  any
  448.  * exception raised during a dnd operation causes the operation to fail silently.
  449.  * passing the function through one of these adapters lets you use "return
  450.  * false on planned failure" symantics, and dumps any exceptions caught
  451.  * to the console. */
  452. function Prophylactic (parentObj, fun)
  453. {
  454.     function adapter ()
  455.     {
  456.         var ex;
  457.         var rv = false;
  458.         
  459.         try
  460.         {
  461.             rv = fun.apply (parentObj, arguments);
  462.         }
  463.         catch (ex)
  464.         {
  465.             dd ("Prophylactic caught an exception:\n" +
  466.                 dumpObjectTree(ex));
  467.         }
  468.         
  469.         if (!rv)
  470.             throw "goodger";
  471.  
  472.         return rv;
  473.     };
  474.     
  475.     return adapter;
  476. }
  477.  
  478. function argumentsAsArray (args, start)
  479. {
  480.     if (typeof start == "undefined")
  481.         start = 0;
  482.  
  483.     if (start >= args.length)
  484.         return null;
  485.     
  486.     var rv = new Array();
  487.     
  488.     for (var i = start; i < args.length; ++i)
  489.         rv.push(args[i]);
  490.     
  491.     return rv;
  492. }
  493.  
  494. function splitLongWord (str, pos)
  495. {
  496.     if (str.length <= pos)
  497.         return [str];
  498.  
  499.     var ary = new Array();
  500.     var right = str;
  501.     
  502.     while (right.length > pos)
  503.     {
  504.         /* search for a nice place to break the word, fuzzfactor of +/-5, 
  505.          * centered around |pos| */
  506.         var splitPos =
  507.             right.substring(pos - 5, pos + 5).search(/[^A-Za-z0-9]/);
  508.  
  509.         splitPos = (splitPos != -1) ? pos - 4 + splitPos : pos;
  510.         ary.push(right.substr (0, splitPos));
  511.         right = right.substr (splitPos);
  512.     }
  513.  
  514.     ary.push (right);
  515.  
  516.     return ary;
  517. }
  518.  
  519. function wrapText (str, width)
  520. {
  521.     var rv = "";
  522.     while (str.length > width)
  523.     {
  524.         rv += str.substr(0, width) + "\n";
  525.         str = str.substr(width);
  526.     }
  527.     return rv + str;
  528. }
  529.  
  530. function wordCap (str)
  531. {
  532.     if (!str)
  533.         return str;
  534.     
  535.     return str[0].toUpperCase() + str.substr(1);
  536. }
  537.  
  538. /*
  539.  * Clones an existing object (Only the enumerable properties
  540.  * of course.) use as a function..
  541.  * var c = Clone (obj);
  542.  * or a constructor...
  543.  * var c = new Clone (obj);
  544.  */
  545. function Clone (obj)
  546. {
  547.     var robj = new Object();
  548.  
  549.     for (var p in obj)
  550.         robj[p] = obj[p];
  551.  
  552.     return robj;
  553.     
  554. }
  555.  
  556. function getXULWindowFromWindow (win)
  557. {
  558.     var rv;
  559.     //dd ("getXULWindowFromWindow: before: getInterface is " + win.getInterface);
  560.     try
  561.     {
  562.         var requestor = win.QueryInterface(nsIInterfaceRequestor);
  563.         var nav = requestor.getInterface(nsIWebNavigation);
  564.         var dsti = nav.QueryInterface(nsIDocShellTreeItem);
  565.         var owner = dsti.treeOwner;
  566.         requestor = owner.QueryInterface(nsIInterfaceRequestor);
  567.         rv = requestor.getInterface(nsIXULWindow);
  568.     }
  569.     catch (ex)
  570.     {
  571.         rv = null;
  572.         //dd ("not a nsIXULWindow: " + formatException(ex));
  573.         /* ignore no-interface exception */
  574.     }
  575.  
  576.     //dd ("getXULWindowFromWindow: after: getInterface is " + win.getInterface);
  577.     return rv;
  578. }
  579.  
  580. function getBaseWindowFromWindow (win)
  581. {
  582.     var rv;
  583.     //dd ("getBaseWindowFromWindow: before: getInterface is " + win.getInterface);
  584.     try
  585.     {
  586.         var requestor = win.QueryInterface(nsIInterfaceRequestor);
  587.         var nav = requestor.getInterface(nsIWebNavigation);
  588.         var dsti = nav.QueryInterface(nsIDocShellTreeItem);
  589.         var owner = dsti.treeOwner;
  590.         requestor = owner.QueryInterface(nsIInterfaceRequestor);
  591.         rv = requestor.getInterface(nsIBaseWindow);
  592.     }
  593.     catch (ex)
  594.     {
  595.         rv = null;
  596.         //dd ("not a nsIXULWindow: " + formatException(ex));
  597.         /* ignore no-interface exception */
  598.     }
  599.  
  600.     //dd ("getBaseWindowFromWindow: after: getInterface is " + win.getInterface);
  601.     return rv;
  602. }
  603.  
  604. function getSpecialDirectory(name)
  605. {
  606.     if (!("directoryService" in utils))
  607.     {
  608.         const DS_CTR = "@mozilla.org/file/directory_service;1";
  609.         const nsIProperties = Components.interfaces.nsIProperties;
  610.     
  611.         utils.directoryService =
  612.             Components.classes[DS_CTR].getService(nsIProperties);
  613.     }
  614.     
  615.     return utils.directoryService.get(name, Components.interfaces.nsIFile);
  616. }
  617.  
  618. function getPathFromURL (url)
  619. {
  620.     var ary = url.match(/^(.*\/)([^\/?#]+)(\?|#|$)/);
  621.     if (ary)
  622.         return ary[1];
  623.  
  624.     return url;
  625. }
  626.  
  627. function getFileFromPath (path)
  628. {
  629.     var ary = path.match(/\/([^\/?#;]+)(\?|#|$|;)/);
  630.     if (ary)
  631.         return ary[1];
  632.  
  633.     return path;
  634. }
  635.  
  636. function getURLSpecFromFile (file)
  637. {
  638.     if (!file)
  639.         return null;
  640.  
  641.     const IOS_CTRID = "@mozilla.org/network/io-service;1";
  642.     const LOCALFILE_CTRID = "@mozilla.org/file/local;1";
  643.  
  644.     const nsIIOService = Components.interfaces.nsIIOService;
  645.     const nsILocalFile = Components.interfaces.nsILocalFile;
  646.     
  647.     if (typeof file == "string")
  648.     {
  649.         var fileObj =
  650.             Components.classes[LOCALFILE_CTRID].createInstance(nsILocalFile);
  651.         fileObj.initWithPath(file);
  652.         file = fileObj;
  653.     }
  654.     
  655.     var service = Components.classes[IOS_CTRID].getService(nsIIOService);
  656.     /* In sept 2002, bug 166792 moved this method to the nsIFileProtocolHandler
  657.      * interface, but we need to support older versions too. */
  658.     if ("getURLSpecFromFile" in service)
  659.         return service.getURLSpecFromFile(file);
  660.  
  661.     var nsIFileProtocolHandler = Components.interfaces.nsIFileProtocolHandler;
  662.     var fileHandler = service.getProtocolHandler("file");
  663.     fileHandler = fileHandler.QueryInterface(nsIFileProtocolHandler);
  664.     return fileHandler.getURLSpecFromFile(file);
  665. }
  666.  
  667. function getCommonPfx (list)
  668. {
  669.     var pfx = list[0];
  670.     var l = list.length;
  671.     
  672.     for (var i = 1; i < l; i++)
  673.     {
  674.         for (var c = 0; c < pfx.length; c++)
  675.             if (pfx[c] != list[i][c])
  676.                 pfx = pfx.substr (0, c);
  677.     }
  678.  
  679.     return pfx;
  680.  
  681. }
  682.  
  683. function renameProperty (obj, oldname, newname)
  684. {
  685.  
  686.     if (oldname == newname)
  687.         return;
  688.     
  689.     obj[newname] = obj[oldname];
  690.     delete obj[oldname];
  691.     
  692. }
  693.  
  694. function newObject(contractID, iface)
  695. {
  696.     if (!jsenv.HAS_XPCOM)
  697.         return null;
  698.  
  699.     var obj = Components.classes[contractID].createInstance();
  700.     var rv;
  701.  
  702.     switch (typeof iface)
  703.     {
  704.         case "string":
  705.             rv = obj.QueryInterface(Components.interfaces[iface]);
  706.             break;
  707.  
  708.         case "object":
  709.             rv = obj.QueryInterface[iface];
  710.             break;
  711.  
  712.         default:
  713.             rv = null;
  714.             break;
  715.     }
  716.  
  717.     return rv;
  718.     
  719. }
  720.  
  721. function keys (o)
  722. {
  723.     var rv = new Array();
  724.     
  725.     for (var p in o)
  726.         rv.push(p);
  727.  
  728.     return rv;
  729.     
  730. }
  731.  
  732. function parseSections (str, sections)
  733. {
  734.     var rv = new Object();
  735.     var currentSection;
  736.  
  737.     for (var s in sections)
  738.     {
  739.         if (!currentSection)
  740.             currentSection = s;
  741.         
  742.         if (sections[s])
  743.         {
  744.             var i = str.search(sections[s]);
  745.             if (i != -1)
  746.             {
  747.                 rv[currentSection] = str.substr(0, i);
  748.                 currentSection = 0;
  749.                 str = RegExp.rightContext;
  750.                 str = str.replace(/^(\n|\r|\r\n)/, "");
  751.             }
  752.         }
  753.         else
  754.         {
  755.             rv[currentSection] = str;
  756.             str = "";
  757.             break;
  758.         }
  759.     }
  760.  
  761.     return rv;
  762. }
  763.  
  764. function replaceStrings (str, obj)
  765. {
  766.     if (!str)
  767.         return str;
  768.     for (var p in obj)
  769.         str = str.replace(RegExp(p, "g"), obj[p]);
  770.     return str;
  771. }
  772.  
  773. function stringTrim (s)
  774. {
  775.     if (!s)
  776.         return "";
  777.     s = s.replace (/^\s+/, "");
  778.     return s.replace (/\s+$/, "");
  779. }
  780.  
  781. function formatDateOffset (seconds, format)
  782. {
  783.     seconds = Math.floor(seconds);
  784.     var minutes = Math.floor(seconds / 60);
  785.     seconds = seconds % 60;
  786.     var hours   = Math.floor(minutes / 60);
  787.     minutes = minutes % 60;
  788.     var days    = Math.floor(hours / 24);
  789.     hours = hours % 24;
  790.  
  791.     if (!format)
  792.     {
  793.         var ary = new Array();
  794.         if (days > 0)
  795.             ary.push (days + " days");
  796.         if (hours > 0)
  797.             ary.push (hours + " hours");
  798.         if (minutes > 0)
  799.             ary.push (minutes + " minutes");
  800.         if (seconds > 0)
  801.             ary.push (seconds + " seconds");
  802.  
  803.         format = ary.join(", ");
  804.     }
  805.     else
  806.     {
  807.         format = format.replace ("%d", days);
  808.         format = format.replace ("%h", hours);
  809.         format = format.replace ("%m", minutes);
  810.         format = format.replace ("%s", seconds);
  811.     }
  812.     
  813.     return format;
  814. }
  815.  
  816. function arrayHasElementAt(ary, i)
  817. {
  818.     return typeof ary[i] != "undefined";
  819. }
  820.  
  821. function arraySpeak (ary, single, plural)
  822. {
  823.     var rv = "";
  824.     
  825.     switch (ary.length)
  826.     {
  827.         case 0:
  828.             break;
  829.             
  830.         case 1:
  831.             rv = ary[0];
  832.             if (single)
  833.                 rv += " " + single;            
  834.             break;
  835.  
  836.         case 2:
  837.             rv = ary[0] + " and " + ary[1];
  838.             if (plural)
  839.                 rv += " " + plural;
  840.             break;
  841.  
  842.         default:
  843.             for (var i = 0; i < ary.length - 1; ++i)
  844.                 rv += ary[i] + ", ";
  845.             rv += "and " + ary[ary.length - 1];
  846.             if (plural)
  847.                 rv += " " + plural;
  848.             break;
  849.     }
  850.  
  851.     return rv;
  852.     
  853. }
  854.  
  855. function arrayOrFlag (ary, i, flag)
  856. {
  857.     if (i in ary)
  858.         ary[i] |= flag;
  859.     else
  860.         ary[i] = flag;
  861. }
  862.  
  863. function arrayAndFlag (ary, i, flag)
  864. {
  865.     if (i in ary)
  866.         ary[i] &= flag;
  867.     else
  868.         ary[i] = 0;
  869. }
  870.  
  871. function arrayContains (ary, elem)
  872. {
  873.     return (arrayIndexOf (ary, elem) != -1);
  874. }
  875.  
  876. function arrayIndexOf (ary, elem, start)
  877. {
  878.     if (!ary)
  879.         return -1;
  880.  
  881.     var len = ary.length;
  882.  
  883.     if (typeof start == "undefined")
  884.         start = 0;
  885.  
  886.     for (var i = start; i < len; ++i)
  887.     {
  888.         if (ary[i] == elem)
  889.             return i;
  890.     }
  891.  
  892.     return -1;
  893. }
  894.     
  895. function arrayInsertAt (ary, i, o)
  896. {
  897.  
  898.     ary.splice (i, 0, o);
  899.  
  900. }
  901.  
  902. function arrayRemoveAt (ary, i)
  903. {
  904.  
  905.     ary.splice (i, 1);
  906.  
  907. }
  908.  
  909. function getRandomElement (ary)
  910. {
  911.     var i = Math.floor (Math.random() * ary.length)
  912.     if (i == ary.length) i = 0;
  913.  
  914.     return ary[i];
  915.  
  916. }
  917.  
  918. function zeroPad (num, decimals)
  919. {
  920.     var rv = String(num);
  921.     var len = rv.length;
  922.     for (var i = 0; i < decimals - len; ++i)
  923.         rv = "0" + rv;
  924.     
  925.     return rv;
  926. }
  927.  
  928. function leftPadString (str, num, ch)
  929. {
  930.     var rv = "";
  931.     var len = rv.length;
  932.     for (var i = len; i < num; ++i)
  933.         rv += ch;
  934.     
  935.     return rv + str;
  936. }
  937.     
  938. function roundTo (num, prec)
  939. {
  940.     return Math.round(num * Math.pow (10, prec)) / Math.pow (10, prec);
  941. }
  942.  
  943. function randomRange (min, max)
  944. {
  945.  
  946.     if (typeof min == "undefined")
  947.         min = 0;
  948.  
  949.     if (typeof max == "undefined")
  950.         max = 1;
  951.  
  952.     var rv = (Math.floor(Math.round((Math.random() * (max - min)) + min )));
  953.     
  954.     return rv;
  955.  
  956. }
  957.  
  958. function getStackTrace ()
  959. {
  960.  
  961.     if (!jsenv.HAS_XPCOM)
  962.         return "No stack trace available.";
  963.  
  964.     var frame = Components.stack.caller;
  965.     var str = "<top>";
  966.  
  967.     while (frame)
  968.     {
  969.         var name = frame.name ? frame.name : "[anonymous]";
  970.         str += "\n" + name + "@" + frame.lineNumber;
  971.         frame = frame.caller;
  972.     }
  973.  
  974.     return str;
  975.     
  976. }
  977.  
  978. function getInterfaces (cls)
  979. {
  980.     if (!jsenv.HAS_XPCOM)
  981.         return null;
  982.  
  983.     var rv = new Object();
  984.     var e;
  985.  
  986.     for (var i in Components.interfaces)
  987.     {
  988.         try
  989.         {
  990.             var ifc = Components.interfaces[i];
  991.             cls.QueryInterface(ifc);
  992.             rv[i] = ifc;
  993.         }
  994.         catch (e)
  995.         {
  996.             /* nada */
  997.         }
  998.     }
  999.  
  1000.     return rv;
  1001.     
  1002. }
  1003.  
  1004. function makeExpression (items)
  1005. {
  1006.     function escapeItem (item, first)
  1007.     {
  1008.         // Numbers.
  1009.         if (item.match(/^[0-9]+$/i))
  1010.             return "[" + item + "]";
  1011.         // Words/other items that don't need quoting.
  1012.         if (item.match(/^[a-z_][a-z0-9_]+$/i))
  1013.             return (!first ? "." : "") + item;
  1014.         // Quote everything else.
  1015.         return "[" + item.quote() + "]";
  1016.     };
  1017.     
  1018.     var expression = escapeItem(items[0], true);
  1019.     
  1020.     for (var i = 1; i < items.length; i++)
  1021.         expression += escapeItem(items[i], false);
  1022.     
  1023.     return expression;
  1024. }
  1025.